import request from '@/utils/request'

/**
 * 用户模块接口文档
 * 基础路径：/api/users
 * 响应格式：JSON
 * 认证方式：无（当前为明文验证，生产环境需补充）
 */

/**
 * 用户注册接口
 * @description 新用户注册（账号、密码、邮箱、姓名）
 * @method POST
 * @url /register
 * @param {Object} params - 请求参数
 * @param {string} params.account - 用户登录账号（唯一）
 * @param {string} params.password - 登录密码（明文存储）
 * @param {string} params.email - 注册邮箱
 * @param {string} params.name - 用户姓名
 * @returns {Promise} 注册结果（成功返回用户信息，失败返回错误信息）
 * @example
 * userRegister({
 *   account: 'user123',
 *   password: '123456',
 *   email: 'user@example.com',
 *   name: '张三'
 * })
 */
export function userRegister(params) {
  return request({
    url: '/users/register', // 完整路径：基础路径 + /register
    method: 'post',
    data: params // 请求体参数（自动序列化为 JSON）
  })
}

/**
 * 用户登录接口
 * @description 用户登录（账号、密码明文验证）
 * @method POST
 * @url /login
 * @param {Object} params - 请求参数
 * @param {string} params.account - 用户登录账号
 * @param {string} params.password - 登录密码（明文）
 * @returns {Promise} 登录结果（成功返回用户信息，失败返回错误信息）
 * @example
 * userLogin({
 *   account: 'user123',
 *   password: '123456'
 * })
 */
export function userLogin(params) {
  return request({
    url: '/users/login', // 完整路径：基础路径 + /login
    method: 'post',
    data: params // 请求体参数（自动序列化为 JSON）
  })
}